Skip to content

docs(indexing): §G.5 amendment — index_modality field (not modality)#1728

Merged
earayu merged 1 commit into
mainfrom
architect/g5-modality-rename
Apr 26, 2026
Merged

docs(indexing): §G.5 amendment — index_modality field (not modality)#1728
earayu merged 1 commit into
mainfrom
architect/g5-modality-rename

Conversation

@earayu
Copy link
Copy Markdown
Collaborator

@earayu earayu commented Apr 26, 2026

Summary

Architect amendment to design pack §G.5 disambiguating field name for retrieval-modality discriminator.

Bryce T3.2 implementation (Wave 3 PR #1727 commit 53257881, msg=1a02cbcb) caught: design pack §G.5 narrative used bare modality field on SearchResultMetadata, but D10.h already locked SearchResultMetadata.modality as the content modality (Literal["text", "image"]). The narrative naming would shadow the D10.h field.

Bryce chose index_modality for disambiguation. Architect ack: this is the canonical name; spec amended to match.

Changes

  • §G.5: rename narrative field modalityindex_modality for retrieval-modality discriminator
  • §G.5: add explicit naming amendment note explaining D10.h vs §G.5 orthogonality
  • §G.5: update allowlist enumeration to list all 12 D10.h-locked fields + 3 new v3 fields

Test plan

🤖 Generated with Claude Code

…trieval-modality discriminator

Bryce T3.2 implementation (PR #1727 follow-up commit 5325788 on
chenyexuan/celery-wave3-cutover) flagged a name collision: D10.h
already locked SearchResultMetadata.modality as the content-modality
field (Literal["text", "image"]). v3 design pack §G.5 narrative
re-used `modality` for "which retrieval modality served this hit"
(Literal["vector", "fulltext", "graph", "summary", "vision"]),
which would shadow the D10.h field.

Architect ack of Bryce's chosen disambiguation: rename the new field
to `index_modality`. D10.h `modality` (content) preserved.
SearchResultMetadata gains three new fields total: parse_version /
index_modality / index_state_per_modality. The two are orthogonal —
a hit can be (index_modality="vector", modality="text") or
(index_modality="vision", modality="image").

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@earayu earayu merged commit 239ece0 into main Apr 26, 2026
3 checks passed
@earayu earayu deleted the architect/g5-modality-rename branch April 26, 2026 18:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant